home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / DIZDIR18.ZIP / DIZDIR.DOC < prev    next >
Encoding:
Text File  |  1994-04-01  |  8.3 KB  |  184 lines
  1. DIZDIR Version 1.8a
  2. Copyright (c) 1994 GDSOFT
  3.  
  4. March 31, 1994
  5.  
  6.  
  7. WHAT IS IT :
  8. ------------
  9.  
  10. DIZDIR is a  simple utility that creates an ASCII  file listing of all ZIP,
  11. ARJ, LZH, ARC, and SFX files in a directory on you system, and will use the
  12. FILE_ID.DIZ  or  FILE.DES  or  FILE.DES   included  in  the  archive  as  a
  13. description for the file. Additionally, files can be listed the DO NOT have
  14. a FILE_ID.DIZ  or, ONLY  listed if  they do.  As and  added option, you can
  15. create file lists  containing the filename, size, date  and what I'll refer
  16. to as a ONE-LINER which is the FIRST xxx characters of the FILE_ID.DIZ, all
  17. on one  line. Listings can  be placed  in  ANY ASCII file  anywhere on your
  18. disk.
  19.  
  20. Commonly, on most BBS systems, the file contained in an archive to describe
  21. the  file is  named FILE_ID.DIZ,  however other  variations are FILE.DES or
  22. FILE.SDI.  In this  document, I'll  refer to  this file  regardless of  the
  23. flavor as  the FILE_ID. DIZDIR  will look for  FILE_ID.DIZ first, then  SDI
  24. then DES.
  25.  
  26. The format of the output file that DIZDIR creates is as follows.
  27.  
  28. --------------------------------  RULER --------------------------------------
  29. 0        2         2         3         4         5         6         7
  30. 123456789012345678901234567890123456789012345678901234567890123456789012345678
  31.  
  32. FILENAME.EXT  1234567  03-12-94  The file description  starts here and can  go
  33.                                  on through the next  as many lines as may  be
  34.                                  in the FILE_ID.DIZ.    For PCBOARD the length
  35.                                  of the line CAN NOT exceed 78 characters.
  36.  
  37. BASIC STARTUP :
  38. ---------------
  39.  
  40. Unpack the  distribution archive to some  directory on your disk,  and type
  41. the command  : DIZDIR <ENTER>.  You'll see the following HELP screen :
  42.  
  43. DIZDIR 1.8a (c) 1993,1994 GDSOFT
  44. Purpose : Create files listing from FILE_ID.DIZ,SDI or DES in archives
  45. Usage   : DIZDIR [/f:outputfile] [/p:filepath] [/d:default.diz] [switches ..]
  46.  
  47. Switches :
  48.        /f:c:\outputfile  (default = FILES.BBS)
  49.        /p:c:\filepath (default=Current Directory)
  50.        /d:c:\default.diz (use this if NO DIZ in files and NOT /x switch)
  51.        /o = OVERWRITE output file (default=APPEND)
  52.        /x = DO NOT include files WITHOUT FILE_ID.DIZ (Default=include them)
  53.        /e = ONLY include files WITHOUT FILE_ID.DIZ (overrides /x switch)
  54.        /t = include TITLE string on first line of output (Default = NONE
  55.        /1:### = Write FIRST xxx chars of FILE_ID.DIZ ( create one-liner )
  56.        /s:#   = Use this char in front of LONG Descrip (For PCBOARD)
  57.        /?     = Show this help screen
  58.  
  59. AH... NOW FOR THE GOOD PART
  60. ---------------------------
  61.  
  62. DIZDIR is really  easy to use. It DOES  NOT matter in what order  you enter
  63. the commandline parameters.
  64.  
  65. First off, you'll  need to tell the program  what the name and path  of the
  66. OUTPUT file will be. If you omit  this, DIZDIR will write the output to the
  67. CURRENT directory in  the file named FILES.BBS. To  specify the output file
  68. enter /f:c:\outputfile as part of the commandline.
  69.  
  70. Next, we  have to tell DIZDIR  what directory to look  in for the archives.
  71. ALL ZIP, LZH, ARJ, and ARC files  and their SFX counterparts will be listed
  72. for that directory.  Enter /p:c:\somepath as part of  the commandline. This
  73. is the ONLY parameter that DIZDIR  actually MUST have. Therefore, you could
  74. just enter on the command line  : DIZDIR \somepath, and DIZDIR would create
  75. a list of that directory.
  76.  
  77. Some of  the files in  the directory chosen  may NOT contain  a FILE_ID. In
  78. this case,  you can use the  /d:c:\default.diz to force these  files to ALL
  79. have a default description. This file can  be anywhere on you disk, but you
  80. MUST include the path if not in the current directory.
  81.  
  82. Finally, we have the option switches  which are completely OPTIONAL. The /o
  83. switch permits  OVERWRITING of the  output file if  it already exists.  The
  84. default is to APPEND to the end of this file. The /x and /e switches permit
  85. you to INCLUDE  or EXCLUDE files that DO NOT  have FILE_ID's. The /x switch
  86. EXCLUDE these files from the listing, and the /e switch ONLY includes these
  87. files. Also, the /e switch is EXCLUSIVE and will override the /x switch.The
  88. /t switch  allows the inclusion  of a TITLE  and HEADER at  the top of  the
  89. listing. Again all of these are completely optional.
  90.  
  91. Another USEFUL feature of DIZDIR is  the /1:### switch, where the pounds(#)
  92. are  replaced with  numbers from  20-240. What  DIZDIR will  do here  is to
  93. create a ONE-LINER listing containing the  filename, size, date and the xxx
  94. characters from  the FILE_ID. This switch  may be used in  conjunction with
  95. the other switches (/e,/x,/o).
  96.  
  97. FOR OUR PCBOARD FRIENDS
  98. -----------------------
  99.  
  100. PCBOARD BBS systems  require the multiple line listings  inlcude a vertical
  101. bar (DECIMAL  124 "|") just before  the description line. This  can be done
  102. with DIZDIR by using the /S:#  switch. i.e. /S:| would place this character
  103. in front of  the SECOND description line of a  multiple line file at column
  104. 32. You could  use any character here. Just  remember that PCBOARD requires
  105. DECIMAL 124.
  106.  
  107.  
  108.         EXAMPLES
  109.         --------
  110.  
  111.         DIZDIR  \zip  /o  -  list  all  archives  in  the ZIP directory and
  112.         overwrite FILES.BBS which will be placed in the current directory.
  113.  
  114.         DIZDIR \zip /f:\bbs\Files.bbs /o /x - list ONLY archives in the ZIP
  115.         directory that have a FILE_ID and overwrite \BBS\FILES.BBS.
  116.  
  117.         DIZDIR \zip /f:listfile.txt /d:c:\util\junk.diz - list all archives
  118.         in  the ZIP  directory and   write to  LISTFILE.TXT in  the current
  119.         directory. For files that have no FILE_ID, use "c:\util\junk.txt"
  120.  
  121.         DIZDIR \p:\zip /f:a:\files.txt /1:70 - list all archives in the ZIP
  122.         directory and write to FILES.TXT the  'A' drive. Make the listing a
  123.         ONE-LINER using 70 chars from the FILE_ID.
  124.  
  125.         DIZDIR \p:\uploads /s:| /o - list all archives in the ZIP directory
  126.         and write  to FILES.BBS overwriting  the old file.  Make the output
  127.         PCBOARD  compatible by  placing the  "|" character  at column 32 in
  128.         front of multiple line items.
  129.  
  130.  
  131. I think that you have the idea !!
  132.  
  133.  
  134. ARCHIVE PROGRAMS NEEDED AND LOCATIONS
  135. -------------------------------------
  136.  
  137. DIZDIR recognizes the  extensions ZIP,ARJ,LZH and ARC. In  order for DIZDIR
  138. to work for each  of these respective archives, you MUST have  a copy of at
  139. LEAST ONE of  the following files FOR EACH FORMAT,  SOMEWHERE on your path.
  140. DIZDIR will search  for them, and if NOT found,  will NOT create list items
  141. for these formats. You must then make sure that these files are in the same
  142. directory as DIZDIR.EXE or in a directory listed in your PATH statement.
  143.  
  144. Where I list  more than one program here, DIZDIR  will search for the First
  145. one, then the second  and so on until it finds at  least one of them. Since
  146. ALL DIZDIR  needs to do  is to  unpack  any FILE_ID.DIZ that  exists in the
  147. archive, it really does NOT matter which of these programs that it uses.
  148.  
  149.                 ZIP - PKUNZIP.EXE
  150.                 ARJ - ARJ.EXE
  151.                 ARC - ARC.EXE, ARCE.EXE, ARC.COM, PKXARC.COM or PAK.EXE
  152.                 LZH - LHA.EXE or LHARC.EXE
  153.  
  154. Well, that's pretty much it. I think that you will find DIZDIR easy to use,
  155. FAST, and once you get used to using it, indispensable !! Especially if you
  156. maintain a BBS.
  157.  
  158. If you like DIZDIR, then please register  it. For those who do, I will send
  159. my super dooper BONUS archive as well. Believe me there are many goodies on
  160. this  BONUS  disk.  including  ARCTOOL,  ARCPLUS  and  FILEMANAGER PLUS, an
  161. exciting NEW program which does ALL that you could EVER want a file manager
  162. program to do and MUCH MORE !!!
  163.  
  164. To register :
  165.  
  166.         GDSOFT
  167.         G.D. DAVIS
  168.         57280 Osage Drive
  169.         Goshen, Indiana 46526
  170.  
  171.         Please Include a $15.00 registration fee.
  172.  
  173.         Make sure that you include your return address.
  174.  
  175.  
  176. If you have any comments or questions,  I would REALLY love to receive your
  177. comments  or  suggestions.  I  can  be  reached  by  leaving  mail on GENIE
  178. (G.D.DAVIS) or CompuServe (72067,2726), or write to me at the above address
  179. or better yet,  call GDSOFT BBS (219) 875-8133,  HST 14400,8,N,1 v.32/v.42.
  180. This is a FREE BBS, and you'll  find MANY GDSOFT programs and files as well
  181. as lots of other goodies.
  182.  
  183. Thank you for using DIZDIR.
  184.